docs: deprecation banners + "don't create" notice across all Workflows pages#1088
Open
bets-margulies-vapi wants to merge 1 commit into
Open
docs: deprecation banners + "don't create" notice across all Workflows pages#1088bets-margulies-vapi wants to merge 1 commit into
bets-margulies-vapi wants to merge 1 commit into
Conversation
…rkflows pages Workflows is being deprecated (retiring August 18, 2026). Only the migration guide carried the direct, dated retirement notice; the rest of the Workflows pages had softer "no longer recommended" banners or, in the case of the intro page, a banner actively encouraging new builds. This brings every Workflows page in line: - Adds the dated retirement warning (retires Aug 18, 2026) to the overview, quickstart, and all six example pages, above their existing page-specific recommendation/links. - Replaces the green "Start building today" launch banner on the intro page (fern/workflows.mdx) with the retirement warning, and adds a reminder at the "Creating Your First Workflow" walkthrough. - Makes the messaging explicit that users should NOT create new workflows even though the dashboard still allows it (the dashboard has not yet been updated). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Contributor
|
🌿 Preview your docs: https://vapi-preview-2b660db3-e7bf-4aec-b426-ba13b767c009.docs.buildwithfern.com |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Brings every Workflows documentation page in line with the deprecation. Previously only the migration guide carried the direct, dated retirement notice — the rest had softer "no longer recommended" banners, and the intro page actively encouraged new builds.
fern/workflows.mdx): replaced the green "Start building today" launch banner with the retirement warning, and added a reminder at the top of the "Creating Your First Workflow" walkthrough.Why
Workflows is being retired on August 18, 2026. Users landing on any Workflows page — especially the create/quickstart/intro flows — should see a consistent, unambiguous message: don't build new workflows, migrate existing ones to Squads.
Reviewer notes
/workflows) is configured to redirect to the quickstart, so most visitors may not see it directly — fixed anyway since the content was live and contradicted the deprecation.legacy-migration.mdxbanner was left as-is (already approved/live).🤖 Generated with Claude Code